home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / btrieve / breset / breset.doc < prev    next >
Encoding:
Text File  |  1994-02-05  |  4.3 KB  |  87 lines
  1. BRESET                                                              ReadMe.TXT
  2. ==============================================================================
  3. V 1.2, 2/5/94, John C. Leon
  4. ------------------------------------------------------------------------------
  5.  
  6. BRESET provides a flexible way to reset network workstation Btrieve
  7. connections, selectively or en masse.  THIS IS A POTENTIALLY DISRUPTIVE
  8. OPERATION.  BRESET MUST BE USED WITH EXTREME CAUTION.  AUTHOR TAKES ABSOLUTELY
  9. NO RESPONSIBILITY FOR RESULTS OBTAINED WITH THIS PROGRAM.  Due to the
  10. potentially catastrophic results of improper use of this program, and in the
  11. spirit of sharing, full C++ source is included in this distribution,
  12. including the source for the pieces of the BTC Class Library used in this
  13. program.
  14.  
  15. HOW BRESET CAME TO BE
  16. ---------------------
  17. This program has been in daily use in my work environment for over one year.
  18. We run several large, mission-critical applications that use Brequest and the
  19. Btrieve NLM extensively.  Numerous nightly batch processes require exclusive
  20. access to various Btrieve files.  Despite all requests, our users can't be
  21. relied upon to logoff nightly, and we chose not to enforce time restrictions
  22. on them.  Since the most critical application is "closed" each night (it's a
  23. financial trading room app), no user will be accessing that particular app,
  24. but may be using any one or more related inquiry tools.  Thus, forcing a reset
  25. of their Btrieve connection before running our batches would at worst be an
  26. irritation than a disaster.  BRESET was the answer, providing interesting
  27. flexibility ---
  28.  
  29. USES
  30. ----
  31. BRESET is command-line driven, but makes use of an ASCII file that must be
  32. named BRESET.NOT.
  33.  
  34. 1. TO RESET YOUR OWN WORKSTATION, specify -1 on the command line.
  35.    Example: BRESET -1
  36.  
  37. 2. TO RESET A SINGLE WORKSTATION, specify the Netware connection number.
  38.    Example: BRESET 27
  39.  
  40. 3. TO RESET ALL WORKSTATIONS, simply do not provide any parameters, and do
  41.    NOT have a BRESET.NOT file in the default directory.  If BRESET.NOT is
  42.    present, no harm will be done, but names in that file will not have their
  43.    connection reset.
  44.  
  45. 4. TO RESET ALL BUT SELECTED USERS, create a text file named BRESET.NOT that
  46.    must be in the default directory, and do not specify any command-line
  47.    parameters (other than /B, see below).  Add the LOGIN NAMES of the users
  48.    who should not be reset to this file, one per line (case is insignificant).
  49.    A sample BRESET.NOT is included in this distribution.
  50.  
  51. 5. Note that a batch mode switch exists to override the requirement for user-
  52.    confirmation before performing #3 or #4 above.  This is useful when using
  53.    BRESET in a batch file.  Specifying a parameter of /b bypasses the user-
  54.    confirmation requirement.
  55. 6. As written, the program supports a maximum of 250 exclusions.
  56. 7. If a user listed in BRESET.NOT has multiple active connections, then none
  57.    of the connections for that user will be reset.
  58. 8. BRESET outputs to standard output a list of all user names excluded from
  59.    reset, if any, and a count of their current connections.
  60.  
  61.  
  62. REQUIREMENTS
  63. ------------
  64. 1. Server must be running the Btrieve NLM, and you must be running Brequest.
  65.    This program cannot distinguish between Brequest and Btrieve ... it's up
  66.    to you.  BRESET will abort with a message if neither Brequest or Btrieve
  67.    are loaded.
  68. 2. You must have console operator privileges on your server, and must have
  69.    supervisor rights to the current directory.  BRESET will abort with a
  70.    message if these conditions are not met.
  71. 3. The current directory must be on a network drive.  BRESET will abort with
  72.    a message if this condition is not met.
  73.  
  74.  
  75. PARTING SHOTS
  76. -------------
  77. Comments, constructive criticism and suggestions welcome.  Complete source,
  78. docs, examples, etc for the BTC Class Library can be made available to you
  79. upon request at no cost if you have any interest.  BTC's been a lifesaver to
  80. me for Btrieve programming!
  81.  
  82. John C. Leon                         Residence: 713-359-3641
  83. 3807 Wood Gardens Court              Office:    713-216-4007
  84. Kingwood, TX 77339                   Fax:       713-216-2052
  85.                                      CIS:       72426,2077
  86.                                      Internet:  72426.2077@compuserve.com
  87.